home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 March / macformat-022.iso / Shareware City / Utilities / MacDOS™ 2.0.0ƒ / User's Guide / 13.5 TREE - XCOPY < prev    next >
Encoding:
Text File  |  1994-11-23  |  9.7 KB  |  322 lines  |  [TEXT/ttxt]
  1. TREE
  2.        lists  the  contents  of  a folder by  displaying  its  tree
  3.        structure graphically.
  4.  
  5.    Syntax
  6.        tree [folder] [/[-]A[[:]attribute list]] [/[-]B]
  7.        [/C=creator] [/F] [/[-]L] [/[-]O[[:]ordering list]]
  8.        [/[-]P] [/[-]S] [/T=file type] [/[-]W]
  9.  
  10.    Parameters
  11.        folder
  12.        identifies  the  folder at the root of the  tree.  It  is  a
  13.        folder  name  possibly preceded by a path and  volume  spec.
  14.        If  you  omit folder, TREE lists the contents of the current
  15.        folder.
  16.  
  17.    Switches
  18.        TREE  accepts all the switches of the DIR command,  although
  19.        /B  and  /W  have  no effect. The switch  /F,  accepted  for
  20.        compatibility with DOS, has also no effect.
  21.  
  22.        The  options set for DIR through the system variable  DIRCMD
  23.        also apply to TREE.
  24.  
  25.        Please refer to the section on DIR for the details.
  26.  
  27.    MacDOS vs DOS
  28.        Format of the output
  29.        MacDOS  always displays the tree list in ASCII and does  not
  30.        implement the switch /A of DOS.
  31.  
  32.        DIR switches
  33.        The  MacDOS implementation of TREE supports all the switches
  34.        supported by DIR.
  35.  
  36.        Switches
  37.        By  default,  MacDOS always displays the  files.  Therefore,
  38.        the switch /F of DOS does not have any effect.
  39.  
  40.    Notes
  41.        Listing of files
  42.        MacDOS by default lists the files. You can suppress it  with
  43.        the switch /A:-F.
  44.  
  45.        Recursive listing
  46.        By  default,  MacDOS only lists the contents of the  current
  47.        folder.  To  list the contents of subfolders hierarchically,
  48.        use the switch /S.
  49.  
  50.    Examples
  51.        Please refer to the section about the command DIR.
  52.  
  53.    See Also
  54.        DIR
  55.  
  56.  
  57. TYPE
  58.        displays the content of a text file.
  59.  
  60.    Syntax
  61.        type file [/H | /R]
  62.  
  63.    Parameters
  64.        file
  65.        is  the  name of the file to be displayed, possibly preceded
  66.        by  a  volume  and  path spec. Unless you  use  one  of  the
  67.        switches, TYPE only displays files of type 'TEXT'.
  68.  
  69.    Switches
  70.        /H
  71.        displays  the  data  fork of file in  HEX  and  ASCII.  Non-
  72.        printing  characters are replaced by periods (ie. dots).  /H
  73.        is incompatible with /R.
  74.  
  75.        /R
  76.        displays  the resource fork of file in HEX and  ASCII.  Non-
  77.        printing  characters are replaced by periods (ie. dots).  /R
  78.        is incompatible with /H.
  79.  
  80.    MacDOS vs DOS
  81.        DOS  does not support the two switches to produce HEX  dumps
  82.        of non-text files.
  83.  
  84.    Notes
  85.        Long files
  86.        You  can pause the listing by typing a cntl-S and resume  it
  87.        with a cntl-Q.
  88.  
  89.    Examples
  90.        type autoexec.bat
  91.        type c:\myDir\aTextFile
  92.        type/h data1 > \myHexDumps\data1.hex
  93.        type aFile.rsrc /r | more
  94.  
  95.    Frequently occurring errors
  96.        E40: Not a file of type 'TEXT'
  97.        Without switches, TYPE can only display text files.
  98.  
  99.    See Also
  100.        MORE
  101.  
  102.  
  103. VER
  104.        displays the current version of MacDOS.
  105.  
  106.    Syntax
  107.        ver
  108.  
  109.    MacDOS vs DOS
  110.        The two implementations are identical.
  111.  
  112.  
  113. VERIFY
  114.        directs  MacDOS  to verify that files are written  correctly
  115.        when copied.
  116.  
  117.    Syntax
  118.        verify [ ON | OFF ]
  119.  
  120.    Parameters
  121.        [ ON | OFF ]
  122.        VERIFY ON directs MacDOS to verify the correctness of  disk-
  123.        write  operations  when copying.  VERIFY  OFF  disables  the
  124.        verification  function. Without parameters,  VERIFY  reports
  125.        the current setting.
  126.  
  127.    MacDOS vs DOS
  128.        The two implementations are identical.
  129.  
  130.    Examples
  131.        verify ON
  132.        VERIFY
  133.        verify off
  134.  
  135.  
  136. VOL
  137.        displays the volume name.
  138.  
  139.    Syntax
  140.        vol [volume]
  141.  
  142.    Parameters
  143.        volume
  144.        is  the volume ID. If you omit volume, VOL displays the name
  145.        of the current volume.
  146.  
  147.    MacDOS vs DOS
  148.        Serial number
  149.        MacDOS does not display the serial number of the volume.
  150.  
  151.        Write-protection
  152.        MacDOS notifies you if the volume is write-protected.
  153.  
  154.    See Also
  155.        CD, SUBSTVOL
  156.  
  157.  
  158. WRITE
  159.        writes a line of text to a file opened with OPEN.
  160.  
  161.    Syntax
  162.        write fileID what
  163.  
  164.    Parameters
  165.        fileID
  166.        is  the number returned by OPEN. You can close the file with
  167.        the command CLOSE.
  168.  
  169.        what
  170.        is  the  line of text to be appended to the file. Note  that
  171.        the  text  must be enclosed in double quotes if it  contains
  172.        spaces.
  173.  
  174.    MacDOS vs DOS
  175.        DOS does not support WRITE.
  176.  
  177.    Notes
  178.        Line termination
  179.        WRITE appends a Carriage Return character (CR) to each  line
  180.        of text  before storing it into the file.
  181.  
  182.    Examples
  183.        write 3 "You bet!"
  184.          adds  to  file  #3 a line of text containing  the  string:
  185.           "You bet!".
  186.  
  187.        write %fileID% %aLine%
  188.          adds  the  text  contained in the variable  aLine  to  the
  189.           file whose ID is stored in the variable fileID.
  190.  
  191.    Frequently occurring errors
  192.        E3: File not opened by the user
  193.        You attempted to WRITE a file without OPENing it.
  194.  
  195.    See Also
  196.        OPEN, READ, CLOSE
  197.  
  198.  
  199. XCOPY
  200.        copies folder contents and whole hierarchies of folders.
  201.  
  202.    Syntax
  203.        xcopy source [destination] [/C=creator] [/D:date] [/E] [/P]
  204.        [/S] [/T=file type] [/V]
  205.  
  206.    Parameters
  207.        source
  208.        is  the  name of the folder to be copied, possibly  preceded
  209.        by a path and volume spec. Hidden files are not copied.
  210.  
  211.        destination
  212.        is  the name of an existing folder into which source  is  to
  213.        be  copied, possibly preceded by a path and volume spec.  It
  214.        defaults to the current folder. As files and folders  cannot
  215.        be  copied  onto  themselves, source  and  destination  must
  216.        specify different folders.
  217.  
  218.    Switches
  219.        /C=creator
  220.        specifies that only files of a particular creator are to  be
  221.        copied.  Note that no spaces are allowed on either  side  of
  222.        the   equal  sign  and  that  the  creator  string  is  four
  223.        characters  long.  Therefore, if a creator includes  spaces,
  224.        you  must  double quote the switch (eg. xcopy  \  "/c=ABC  "
  225.        copies  all the files created by 'ABC ' in the root folder).
  226.        This switch does not apply to folders.
  227.  
  228.        /D:date
  229.        only copies files changed on or after the specified date.
  230.  
  231.        /E
  232.        recursively copies all [sub]folders, even if empty.
  233.  
  234.        /P
  235.        prompts   you   for   confirmation  before   creating   each
  236.        destination file.
  237.  
  238.        /S
  239.        recursively copies subfolders, except if empty.
  240.  
  241.        /T=file type
  242.        specifies  that only files of a particular type  (eg.  TEXT)
  243.        are  to be copied. Note that no spaces are allowed on either
  244.        side  of  the  equal  sign and that the file  type  is  four
  245.        characters long. Therefore, if a file type includes  spaces,
  246.        you  must  double quote the switch (eg. xcopy  \  "/t=ABC  "
  247.        copies  all  the files of type 'ABC ' in the  root  folder).
  248.        This switch does not apply to folders.
  249.  
  250.        /V
  251.        re-reads  destination files to verify that  they  have  been
  252.        copied correctly.
  253.  
  254.    MacDOS vs DOS
  255.        Switches
  256.        MacDOS  does  not implement /A, /M, and /W,  but  introduces
  257.        the  new  switches  /C and /T. MacDOS  assumes  /S  when  it
  258.        encounters   /E,  while  with  DOS  the  two  switches   are
  259.        independent.
  260.  
  261.        Destination is a folder
  262.        MacDOS only accepts a folder specification as destination.
  263.  
  264.        Folders replacing files
  265.        When  a  folder in source has the same name  as  a  file  in
  266.        destination,  MacDOS deletes the file and then  creates  the
  267.        folder,  thereby effectively replacing a file with a folder.
  268.        Nevertheless,   the  item  identified   in   the   parameter
  269.        destination itself must be a folder.
  270.  
  271.        Folders becoming empty
  272.        With  the  switch  /S (not /E), only non-empty  folders  are
  273.        copied.  Nevertheless, this can result in empty  folders  in
  274.        the  destination tree when /C or /T filters are applied  and
  275.        no files in a particular source folder passes them.
  276.  
  277.    Notes
  278.        Aliases
  279.        Aliases  are  not  resolved. Therefore,  aliased  files  and
  280.        folders  appear in the destination folder as  they  appeared
  281.        in the source (ie. as aliases).
  282.  
  283.        Specifying dates
  284.        When  you  use  the switch /D and one or both  of  the  date
  285.        field  separators are slashes, enclose the switch in  double
  286.        quotes.   This   is   necessary  to  prevent   MacDOS   from
  287.        interpreting a date field as a switch.
  288.  
  289.    Examples
  290.        xcopy dir1 dir2
  291.          copies  the  contents of the folder dir1 into  the  folder
  292.           dir2.  Both  dir1 and dir2 are subfolders of the  current
  293.           folder.
  294.  
  295.        xcopy/s dir1 a: "/d:93/09/20"
  296.          copies  the  contents of the folder dir1 to  drive  A.  It
  297.           reproduces  the hierarchical structure of dir1  but  only
  298.           copies files modified on or after September 20th, 1993.
  299.  
  300.        xcopy/e dir1 dir1Struct /c=mDOS /t=ABCD
  301.          duplicates  the  hierarchical structure  of  dir1  in  the
  302.           folder  dir1Struct. All destination folders remain  empty
  303.           because MacDOS (creator 'mDOS') never generates files  of
  304.           type  'ABCD'.  Any  non-existing creator,  file-type,  or
  305.           combination of them will achieve the same result.
  306.  
  307.    Frequently occurring errors
  308.        E27: File or directory not found
  309.        The  source parameter did not identify any file  at  all  or
  310.        one  of  the  folders specified in the  path  could  not  be
  311.        found.  Note that creator and file type are case  sensitive.
  312.        Therefore, /T=text will not find any file of type 'TEXT'.
  313.  
  314.        E28: Bad switch
  315.        Perhaps  you  failed  to  specify a  creator  or  file  type
  316.        correctly.  The  equal  sign  is  mandatory  and  all   four
  317.        characters which form the OSType must be provided.
  318.  
  319.    See Also
  320.        COPY
  321.  
  322.